.. _cmlMxWaitDone:

cmlMxWaitDone
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

  VT_I4 cmlMxWaitDone ([in] VT_I4 BoardID, [in] VT_I4 NumAxes, 
  [in] VT_PI4 NumChannel, [in] VT_I4 IsBlocking)  

DESCRIPTION
`````````````  

- 여러 축에 대하여 모션이 완료(完了)될 때까지 기다립니다. 이 함수는 다축제어뿐 아니라 
  원점복귀(原點復歸)나 단축(單軸)모션제어 작업시에도 활용할 수 있습니다. 
 
\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cml 가 붙지 않습니다.

PARAMETER
`````````````

▶ BoardID : 사용자가 설정한 디바이스(보드) ID. 
 
▶ NumAxes : 동시에 작업을 수행할 대상 축의 수 
 
▶ NumChannel : 동시에 작업을 수행할 대상 축의 배열 주소값. 이 배열의 크기는 
NumAxes값과 일치하거나 커야 합니다. 
 
▶ IsBlocking : 완료될 때까지 기다리는 동안 윈도우 메시지를 블록(Blocking)할 것인지를 
결정합니다.   

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

    Value, Meaning
    "| cmlFALSE", "
     |               블록(Blocking)을 하지 않습니다. 따라서 해당 모션이 완료되는 
     |               동안에도 윈도우 이벤트를 처리합니다."  
    "| cmlTRUE", "
     |               블록(Blocking)을 합니다. 따라서 해당 모션이 완료되는 동안에는 
     |               윈도우 이벤트가 처리되지 않습니다. "                

RETURN VALUE
`````````````

+------------+-----------+
|    Value   | Meaning   |
+============+===========+
|    음수    | 수행 실패 |
+------------+-----------+
| ERR_NONE   | 수행 성공 |
+------------+-----------+


REFERENCE
`````````````

- INP 입력신호가 Enable로 설정되었으면 Command 펄스 출력이 완료되어도 INP 입력이 
  ON이 되기 전까지는 모션이 완료되지 않은 것으로 간주되어 반환되지 않습니다.  



.. note:: "윈도우 이벤트라는 것은 무엇입니까?"
    윈도우 운영체제는 Event Driven 혹은 Message Driven 방식의 구조로 되어 
    있습니다. 각 응용프로그램은 메시지 큐(Queue)를 가지고 있으며, 정확히 
    말하면, 메시지를 사용해 이벤트를 통지하는 방식으로 설계되어 
    있습니다. 윈도우 메시지를 처리한다는 것은 메시지 큐에서 메시지를 
    하나씩 꺼내서 윈도우 프로시저에 전송한다는 것을 의미하며, 이것은 그 
    행선지가 되는 윈도우에 전송되어 처리됩니다.     
    

EXAMPLE
`````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

  C/C++  

  Long BoardID = 0; 
  long nNumChannel[2] = {cmX1, cmY1}; 
  double fDistList[2] = {1000, 1000}; 
  if(cmlMxMoveStart(BoardID, 2, nNumChannel, fDistList) != ERR_NONE){ 
  //Handle 은 사용자가 생성한 폼의 핸들 값입니다. 
  // 에러메시지 출력 
  return ; 
  } 
  //모션이 완료 될 때 까지 기다립니다. 
  if(cmlMxWaitDone(BoardID, 2, nNumChannel, cmlFALSE) != ERR_NONE){ 
  // 에러메시지 출력 
  return ; 
  } 

.. code-block:: c++
 :linenos:

  Visual Basic 

  Dim BoardID As Long 
  Dim nNumChannel(1) 
  Dim fDistList(1) 
  BoardID = 0; 
  „ 대상 축 설정  
  nNumChannel(0) = cmX1 
  nNumChannel(1) = cmY1 
  „ 대상 축에 대한 이송 거리 설정 
  fDistList(0) = 1000 
  fDistList(1) = 1000 
  if(MxMove(BoardID, 2, nNumChannel(0), fDistList(0), cmlFALSE) <> ERR_NONE) then 
  // 에러메시지 출력 
  exit sub 
  end if 
  ‘Wait till motion done 
  if(MxWaitDone(BoardID, 2, nNumChannel(0), cmlFALSE) <> ERR_NONE) then 
  // 에러메시지 출력 
  exit sub 
  end if 

.. code-block:: c++
 :linenos:

  Delphi 

  BoardID := 0; 
  // 대상 축 설정 
  nNumChannel[0] := cmX1; 
  nNumChannel[1] := cmY1; 
  // 대상 축에 대한 이송 거리 설정 
  fDistList[0] := 1000; 
  fDistList[1] := 1000; 
  if(cmlMxMove(BoardID, 2, @nNumChannel, @fDistList, cmlFALSE) <> ERR_NONE) then begin 
  // 에러메시지 출력 
  // 적절한 에러처리를 수행합니다. 
  end; 
  // Wait till motion done // 
  if(cmlMxWaitDone(BoardID, 2, @nNumChannel, cmlFALSE) <> ERR_NONE) then begin 
  // 에러메시지 출력 
  exit; 
  end; 


SEE ALSO
```````````````

.. seealso:: :ref:`cmlMxIsDone`